home *** CD-ROM | disk | FTP | other *** search
/ The Original Shareware 1.1 / The Original Shareware (WeMake CDs)(Volume 1.1)(CDs, Inc)(1993).iso / 16 / pckat12.zip / MANUAL.OUT < prev    next >
Text File  |  1986-03-17  |  93KB  |  2,443 lines
  1.  
  2.                                     PC-KAT (TM)
  3.  
  4.                             The Easy, Practical, Super
  5.                             Capacity Diskette Cataloger
  6.  
  7.  
  8.                                     USER MANUAL
  9.  
  10.  
  11.                                         by
  12.                                     R.H. Martin
  13.  
  14.  
  15.  
  16.                               Applied Foresight (TM)
  17.                                   P.O. Box 20607
  18.                              Bloomington, Minn.  55420
  19.  
  20.  
  21.                                  January 17, 1986
  22.                                     Version 1.2
  23.  
  24.  
  25.  
  26.                            Copyright 1986 by R.H. Martin
  27.                                 All Rights Reserved
  28.  
  29.  
  30.  
  31.                             A DB-SHARE Software Product
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                     A limited license is hereby granted to copy
  39.                   and distribute wholly unmodified copies of the
  40.                 PC-KAT Software Diskette which contains this manual
  41.  
  42.                      (Read the manual, "THE DB-SHARE PROGRAM"
  43.                    for full details about this limited license)
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                                              Trademark Pending
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 2
  69.  
  70.  
  71.  
  72.                                  TABLE OF CONTENTS
  73.                                  -----------------
  74.  
  75.      Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  76.      About This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
  77.         General
  78.         Trademarks
  79.      Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  80.         Overview
  81.         Philsophy Of PC-KAT
  82.         Using PC-KAT With The IBM AT
  83.         PC-KAT Base System Features
  84.      Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 7
  85.         Minimum Requirements
  86.         Recommended Options
  87.         Commentary
  88.      Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
  89.         Overview
  90.         Installation Instructions
  91.         Installation For Non-IBM Compatible MS-DOS PC
  92.         Additional Install Information For Hard Disk Users
  93.            Who Power On Their Computer With A Startup Diskette
  94.      Updating The PC-KAT System Control Record . . . . . . . . . . . . . . .13
  95.      Cataloging Diskettes. . . . . . . . . . . . . . . . . . . . . . . . . .21
  96.      Inquiring Against The PC-KAT Catalog. . . . . . . . . . . . . . . . . .26
  97.      Taking Care of Your Database. . . . . . . . . . . . . . . . . . . . . .30
  98.         Overview
  99.         Conservative Updating
  100.         Backup
  101.         The Log File
  102.         Integrity Analysis
  103.         Trouble Shooting Tips
  104.      Online Assistance . . . . . . . . . . . . . . . . . . . . . . . . . . .35
  105.      Appendix A: The KPRINT Print Program. . . . . . . . . . . . . . . . . .36
  106.      Appendix B: Provided PC-KAT Files . . . . . . . . . . . . . . . . . . .37
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 3
  135.  
  136.  
  137.                                  ABOUT THIS MANUAL
  138.                                  -----------------
  139.  
  140.                                       GENERAL
  141.  
  142.      A section is designated by a centered and underlined heading.  Centered
  143.      but NOT underlined headings are referred to as a subsection.
  144.  
  145.      Absolutely, do not use PC-KAT prior to thoroughly following the
  146.      installation instructions, including restarting your computer after
  147.      following the installation instructions.
  148.  
  149.      This manual explains what you minimally need to read in order to use the
  150.      software.  After you are comfortable with the program, or if you have
  151.      additional questions, you can print out and read the TECHNICAL REFERENCE
  152.      MANUAL.
  153.  
  154.      Please read each section of this manual before using PC-KAT.  It won't
  155.      take you long.
  156.  
  157.  
  158.                                     TRADEMARKS:
  159.  
  160.      "COMPAQ and COMPAQ PLUS" are trademarks of COMPAQ Corporation.
  161.      "MS-DOS" is a trademark of Microsoft Corporation.
  162.      "PC-DOS and IBM" are trademarks of International Business Machines Corp.
  163.      "PC-WRITE and Quicksoft" are trademarks of Quicksoft.
  164.      "DB-VISTA" is a trademark of RAIMA Corporation.
  165.      "Lattice" is a trademark of Lattice Inc.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 4
  201.  
  202.  
  203.                                    INTRODUCTION
  204.                                    ------------
  205.  
  206.                                      OVERVIEW
  207.  
  208.      PC-KAT is an easy, practical, super capacity diskette cataloger for
  209.      owners of IBM PC computers and compatibles.  Without sacrificing
  210.      processing performance, it can manage up to 9,999 diskettes and 16
  211.      million filenames in one central database.
  212.  
  213.      PC-KAT is primarily aimed at hard disk owners, who utilize floppy
  214.      diskettes for backup and archival purposes.  However, if the hard disk
  215.      owner has a tape device which fools DOS into thinking it is a large
  216.      diskette, then PC-KAT should also be able to process the filenames on
  217.      those tape cartridges.  If you are able to do so, please report your
  218.      success to Applied Foresight.
  219.  
  220.      There are other diskette catalogers, all of which seem to be addressed to
  221.      floppy disk owners, for only one of them can contain more than a few
  222.      thousand file names, and that one only 32,000 file names.  These other
  223.      products, in the reviewed version levels, respectively can only handle a
  224.      maximum of 780, 3000 and 4,326 filenames in one diskette catalog file.
  225.  
  226.      PC-KAT is 99% written in the C programming language (Lattice C), the
  227.      remainder in Assembler.  It uses a run-time royalty-free and license-free
  228.      network model database manager, called DB-VISTA by RAIMA Corporation,
  229.      11717 Rainier Avenue South, Seattle, WA 98178.
  230.  
  231.      Another benefit of PC-KAT is the printer program which printed this
  232.      manual for you.  KPRINT has an abundant number of printer features which
  233.      makes it ideal for printing out source code of programs and other types
  234.      of plain ASCII files.  It has gone through over 30 upgrades because of
  235.      numerous upgrade requests.  Online help is available by just typing in
  236.      KPRINT and pressing the ENTER key.
  237.  
  238.  
  239.                                 PHILSOPHY OF PC-KAT
  240.  
  241.      PC-KAT follows the DB-SHARE distribution concept, developed by PC-KAT's
  242.      author and separately explained in THE DB-SHARE PROGRAM manual.
  243.  
  244.      The purpose of the PC-KAT software is to maintain a master catalog of all
  245.      diskette filenames that can be inquired against quickly to inform you
  246.      which diskette(s) contains the filename(s) you are looking for.
  247.  
  248.      Simply put, PC-KAT requires that you physically label all your diskettes
  249.      starting with the label 0001 up through 9999 and that you stack your
  250.      diskettes sequentially in numeric order.  It makes no difference how
  251.      unrelated any neighboring sequenced diskette is, for PC-KAT will provide
  252.      the logical organization to your diskettes.  Then all you have to do is
  253.      let PC-KAT "look" at each one of your diskettes as they are used.
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 5
  267.  
  268.  
  269.      Simply doing this, PC-KAT can always tell you quickly where is something
  270.      you want.  You can start using your diskettes to contain critically
  271.      needed current files.  You can delay updating the hard disk capacity of
  272.      your computer.  You can start thinking of your diskettes as being as
  273.      accessible to you as another hard disk subdirectory, for you will be able
  274.      to find out directory information about any file you have worked with,
  275.      regardless of whether it is currently on your hard disk or now on a
  276.      floppy.
  277.  
  278.      The philosophy of PC-KAT is to make managing your diskette filenames as
  279.      effortless as possible.  Once you have installed PC-KAT, and set up your
  280.      PC-KAT system control record, the minimal amount of typing you have to do
  281.      in the lifetime of a single diskette, while you are inside the PC-KAT
  282.      program, is to assign a 4 digit ID number, once, to the diskette.
  283.      Everything else is automatically done for you based upon the directory
  284.      information contained on the diskette and the default information for
  285.      diskettes existing in the system control record.
  286.  
  287.      Alternatively, if you so desire, you can maintain unique information
  288.      about individual diskette volumes.  When you invoke the PC-KAT program at
  289.      the DOS system prompt, you indicate whether you want to be prompted for
  290.      manual entry of volume label textual information or whether you desire to
  291.      avoid these prompts and to instead have default information apply.
  292.  
  293.      The subdirectory which a diskette file may optionally reside in is
  294.      cataloged by PC-KAT without requiring any action by the user.  Many IBM
  295.      AT owners may appreciate this PC-KAT feature.  With the 1.2 MB capacity
  296.      floppies, there is increasing use of making subdirectories on floppies.
  297.      You do not need an IBM AT to make subdirectories on your floppies.  Just
  298.      type: MD A:\SUBDIR and press ENTER to create the directory called,
  299.      \SUBDIR, on drive A.
  300.  
  301.  
  302.                             PC-KAT BASE SYSTEM FEATURES
  303.  
  304.      OVERALL FEATURES:
  305.      * Accomodates 9,999 diskettes containing up to 16 million filenames in
  306.        one central database.
  307.      * Diskette filenames cataloged without any data entry required.
  308.      * Designed to meet the diskette cataloging needs of hard disk owners.
  309.      * Enables hard disk owners to consider their diskettes an extension of
  310.        their hard disk subdirectories.
  311.      * Condensed online help screen.
  312.      * Feature-rich programmer source code print program included.
  313.      * Thorough documentation, including recovery documentation.
  314.  
  315.      CATALOG UPDATING FEATURES:
  316.      * Add or change a 4 digit diskette volume label within program.
  317.      * Optionally create unique header record for each cataloged diskette.
  318.      * Diskette header carries freespace and filesum number for each diskette
  319.        without any user entry involved.
  320.      * User-created default answers to diskette header fields, which can be
  321.        changed or over-ridden.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 6
  333.  
  334.  
  335.      * Files located in diskette subdirectories are automatically cataloged.
  336.      * Does directory lists, deletes, or format of diskettes within program.
  337.      * Does a database backup while in the program.
  338.      * Alternate between diskette drives A: and B: while within program.
  339.      * Empty diskettes are specially processed as scratch diskettes.
  340.      * Optimized for speed, written in C using DB_VISTA database manager.
  341.      * Recognize a previously cataloged, unchanged diskette, informs the user
  342.        and bypasses recataloging.
  343.      * Optional support for RAM disk utilization for program work files.
  344.      * Uses file compression techniques.
  345.      * Maintains a log file of 4 digit volume IDs processed, which can aid
  346.        database recovery if the database is ever damaged.
  347.  
  348.      CATALOG INQUIRY FEATURES:
  349.      * Password required to view contents of database, --database owner can
  350.        change this password (i.e., 2 passwords: user's & owner's).
  351.      * Lists all database filenames or diskette header records, or subsets of
  352.        either.
  353.      * Can list diskettes by volume ID order or by descending free space
  354.        order.
  355.      * Can list diskettes whose header record meets the selection criteria
  356.        given by user.
  357.      * Provides list of scratch diskettes.
  358.      * Easy method to list what diskettes hold backups of PC-KAT database.
  359.      * Diskette list shows the previous & following diskette volume for a
  360.        multi-diskette set.
  361.      * Identifies BACKUP or other type volume.
  362.      * Lists uncataloged diskette numbers available.
  363.      * Selection can be by exact or partial match.
  364.      * User's search phrase can be exact length or be a left justified
  365.        substring or floating substring.
  366.      * Selection can include the filename, file extension, and/or subdirectory
  367.        name.
  368.      * Retrieval can be limited to entries cataloged at home, work or at both
  369.        locations.
  370.      * Listings can be directed to the screen, printer or file.
  371.      * Listings can be interrupted by pressing the ESC key.
  372.      * Screen listings pause until any key is pressed.
  373.      * Listings carry a date/time stamp and headings.
  374.      * Retrieval list can be sorted in reverse chronological order.
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 7
  399.  
  400.  
  401.                                HARDWARE REQUIREMENTS
  402.                                ---------------------
  403.  
  404.                                MINIMUM REQUIREMENTS
  405.  
  406.      You minimally need the following for PC-KAT:
  407.  
  408.         192K RAM memory free (256 KB RAM available);
  409.         Fixed Hard Disk -- see exception note below;
  410.         80-column monitor;
  411.         MS-DOS or PC-DOS 2.0 or higher;
  412.         a CONFIG.SYS file [create or modify yours as instructed in this
  413.            manual];
  414.         IBM PC,XT,AT or compatible
  415.  
  416.      You are advised to have at least 196,608 bytes of RAM or 192K RAM free
  417.      before running PC-KAT.  Therefore, you should have at least 256K RAM
  418.      available.  PC-KAT may run slightly under that amount of RAM free space,
  419.      but you do so at your own risk.
  420.  
  421.  
  422.                                 RECOMMENDED OPTIONS
  423.  
  424.      The following options are recommended.
  425.  
  426.         a computer printer capable of continuous printing and printing 80
  427.            columns per line;
  428.         a RAM disk-emulator (requires additional memory and RAM software) to
  429.            hold frequently called subprograms and run-time, temporary work
  430.            files;
  431.  
  432.      The printer will allow you to use those PC-KAT options which utilize the
  433.      printer.  The RAM disk-emulator will not give you any extra features, but
  434.      will provide better performance.  If you are a novice DOS 2.00+ user, you
  435.      don't need to immediately worry about what a "RAM disk" is and how to
  436.      create one.  Over the weeks or months that you use PC-KAT, you might want
  437.      to buy a DOS tutorial book, which will educate you about DOS and what a
  438.      "RAM DISK" is.  But for now, ignore discussions about "RAM DISKS".
  439.  
  440.      If you have an IBM AT, it's PC-DOS 3.0 supplies the capability to create
  441.      a RAM disk.  If you consider yourself past the DOS novice stage, read up
  442.      on your CONFIG.SYS and VDISK.SYS files.
  443.  
  444.  
  445.                                     COMMENTARY
  446.  
  447.      In lieu of a fixed hard disk, if you own an IBM AT with dual floppy
  448.      drives, one of them being a high capacity 1.2 MB disk drive, you could
  449.      conceivably use this software.
  450.  
  451.      With the PC-KAT software and even a small PC-KAT database (after a
  452.      month's usage), you'll be using up at least 500,000 bytes or 0.5 MB of
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 8
  465.  
  466.  
  467.      disk space.  Covering 523 diskettes and 11,550 filenames, will require
  468.      less than 1.25 MB of space).  This 1.3 MB figure includes the PC-KAT
  469.      software space requirements.
  470.  
  471.      You may ask: "How will PC-KAT help me avoid needing extra hard disk space
  472.      if PC-KAT will swallow between 1.25 MB of disk space?"  The answer is
  473.      that if you could rapidly access data files from your diskettes as easy
  474.      as you currently do a DOS DIR command for the location of a desired file
  475.      and your subsequent change to another hard disk directory to access that
  476.      file (else your COPY command against that file residing in the other
  477.      directory), then chances are that you would find yourself with 20-40%
  478.      more free space on your hard disk.
  479.  
  480.      PC-KAT allows you to offload between 20-40% of your hard disk space,
  481.      which is probably now eaten up by moderately or infrequently accessed
  482.      data files, on to floppies.  You can leave your hard disk to keep
  483.      executeable programs and required companion files (e.g., program Help or
  484.      Screen files), as well as constantly accessed data files or databases.
  485.      You are advised to always offload files twice to different diskettes
  486.      before deleting these files on your hard disk.
  487.  
  488.      There are other reasons for PC-KAT, which offset the disk space that PC-
  489.      KAT imposes.  These other reasons are rapid access to archived files and
  490.      prior version files.  If you acquire the add-on PC-KAT software modules,
  491.      you'll have additional reasons to put up with the slight loss of hard
  492.      disk space because of PC-KAT.  Type KAT -O for a printout about the PC-
  493.      KAT add-on software modules.
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 9
  531.  
  532.  
  533.                                    INSTALLATION
  534.                                    ------------
  535.  
  536.  
  537.                                      OVERVIEW
  538.  
  539.      Installation requires that you configure your operating system
  540.      environment to satisfactorily accomodate database management processing
  541.      and that you install the PC-KAT software on your hard disk.
  542.  
  543.      For those users who understand DOS well and are impatient to proceed on
  544.      to the next section, I'll state the installation procedure fast.  If you
  545.      don't know what is being talked about, skip the following subsection and
  546.      print out and refer to the accompanying manual, INSTALLATION FOR NEW
  547.      COMPUTER USERS.  In that manual, you'll be walked through the
  548.      installation procedure step-by-step, slowly.
  549.  
  550.      At the end of either installation method, you'll end up with some install
  551.      files that don't need to be on your hard disk.  To delete these files and
  552.      the print process from your hard disk, position your cursor in the same
  553.      directory on your hard disk where you installed PC-KAT and type:
  554.         DEL  KATAD.*      and press ENTER.
  555.         DEL  USQ.*        and press ENTER.
  556.         DEL  KATBOOK*.*   and press ENTER.
  557.         DEL  *.OQT        and press ENTER.
  558.         DEL  READ.ME      and press ENTER.
  559.  
  560.  
  561.                           SHORT INSTALLATION INSTRUCTIONS
  562.                          FOR THE DOS 2.0+ EXPERIENCED USER
  563.  
  564.      Installation requires the following specific acts (assume drive A is a
  565.      floppy and drive C is a hard disk):
  566.  
  567.         1.  Make a duplicate copy of your PC-KAT diskette for archival
  568.             purposes.
  569.  
  570.         2.  Put the PC-KAT diskette in drive A.  Type:  COPY  A:KATDB.*  C:\/V
  571.             and press the ENTER key.
  572.  
  573.             You are highly recommended to put your KATDB.* files in your root
  574.             directory.  If you put them in a subdirectory, then you must
  575.             always invoke a PC-KAT program with a -L option and be sitting in
  576.             that directory at run time.  Specific syntax examples are given
  577.             later.
  578.  
  579.             Putting the KATDB.* files in your root, means that you can be
  580.             anywhere on your hard disk and from that location run PC-KAT.
  581.             However, this assumes that you have a PATH statement which
  582.             minimally encompasses your root directory.  The following PATH
  583.             statement is minimally correct:
  584.                PATH=C:\
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 10
  597.  
  598.  
  599.  
  600.             If you need to create or update your PATH statement, include the
  601.             PATH command line (such as the above) in your C:\AUTOEXEC.BAT
  602.             file.  If you don't have a C:\AUTOEXEC.BAT file, then minimally
  603.             create one which looks like the one below.  Use any editor which
  604.             can update a plain vanilla ASCII file (e.g., EDLIN, PC-WRITE, EC).
  605.             The PROMPT line is optional.  It will show you to the left of the
  606.             prompt sign, your current directory area.  A minimal
  607.             C:\AUTOEXEC.BAT file should include:
  608.                DATE
  609.                TIME
  610.                PATH=C:\
  611.                PROMPT $P$G
  612.  
  613.             If you are DOS 1.1 experienced, the filename "C:\MYFILE", means a
  614.             file, of the name "MYFILE" which resides in the root directory "\"
  615.             of drive "C:".  If your cursor is positioned already in the root
  616.             directory of C:, then you can ignore the "\" symbol.
  617.  
  618.         3.  Put the remaining PC-KAT diskette files somewhere along your PATH.
  619.             Also include in your path, your DOS programs, SORT, MORE and
  620.             FORMAT.  If you don't have or want a PATH statement in your
  621.             environment, put the entire PC-KAT diskette files in your root
  622.             directory.  For instance, type: COPY  A:*.*  C:\/V and press the
  623.             ENTER key to put everything in your root directory.
  624.  
  625.         4.  Either create, update, or verify that your C:\CONFIG.SYS file
  626.             exists and has the following two lines in it:
  627.                FILES=20
  628.                BUFFERS=15
  629.             If you have an IBM AT, you could make the BUFFERS=25 instead.
  630.             The BUFFERS line is not needed by PC-KAT, but since you're
  631.             changing CONFIG.SYS, you might as well optimize your BUFFERS line.
  632.  
  633.         5.  This is an optional step and not required.  If you don't have a
  634.             RAM disk, proceed to step 6.
  635.  
  636.             If you have a RAM disk, which is uploaded with files at power up
  637.             time with file copying going on in your C:\AUTOEXEC.BAT file,
  638.             consider putting the following files in your RAM disk.  This is
  639.             not required, but will give you performance improvement.  The
  640.             files include SORT.EXE, which comes on your original DOS diskette.
  641.             The files that you should consider putting in your RAM disk are:
  642.                SORT.EXE
  643.                KATDRIVE.EXE
  644.  
  645.             Also consider leaving spare space on your RAM disk of at least
  646.             30,000 bytes.  This empty space can be used by PC-KAT for its run-
  647.             time, temporary work files.  For your information, the names of
  648.             these run-time files are KATWORK1.DIR, KATWORK2.DIR, and
  649.             KATWORK.VOL.  You may have to also update your C:\CONFIG.SYS if
  650.             your RAM disk space alottment is done in that file.  If you use
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 11
  663.  
  664.  
  665.             IBM AT high capacity floppies and store a high number of files on
  666.             them, you may need to allocate more than 30,000 bytes to
  667.             accomodate these work files.
  668.  
  669.             The last advise for RAM disk owners, is to put the drive
  670.             designation for your RAM disk at the start of the left hand side
  671.             of your PATH statement, so that your RAM disk gets looked at first
  672.             down your PATH.  If drive D is your RAM disk, then minimally your
  673.             PATH statement should include:
  674.                PATH=D:\;C:\
  675.  
  676.         6.  Restart your computer now.
  677.  
  678.         7.  Excepting those with less than 100% IBM PC Compatibility or those
  679.             who power on their computer with a startup diskette, you can go to
  680.             the next section, "Updating The PC-KAT System Control Record."
  681.             Those whose computers are neither IBM nor as compatible to an IBM
  682.             as a COMPAQ is, should read the next subsection before proceeding
  683.             to the next section.  Those who use a startup diskette should read
  684.             the section immediately following.
  685.  
  686.  
  687.                              INSTALLATION FOR NON-IBM
  688.                                COMPATIBLE MS-DOS PC
  689.  
  690.      The author has not tested this software on non-IBM compatible MS-DOS
  691.      computers.  It was developed on a COMPAQ PLUS computer however.  The
  692.      rapid display of PC-KAT's signon and usage screen is the most IBM
  693.      specific piece of code knowingly used.  As said, this does work on a
  694.      COMPAQ PLUS.  However, it might not work on less compatible MS-DOS
  695.      computers.  For this reason, the user can disable this direct IBM-type
  696.      screen use.
  697.  
  698.      To do this, type in the following, with your prompt at the "C" level.
  699.      Type:   ECHO  X>\IAMNOTAN.IBM   and press the ENTER key.  This is all you
  700.      have to do.  What you've done is create a one byte file in your root
  701.      directory of your hard disk.  The drive must be the same as the drive
  702.      where your PC-KAT database resides.  PC-KAT will utilize a less machine
  703.      specific screen display method if it finds this file to exist.
  704.  
  705.  
  706.                 ADDITIONAL INSTALL INFORMATION FOR HARD DISK USERS
  707.                 WHO POWER ON THEIR COMPUTER WITH A STARTUP DISKETTE
  708.  
  709.      1. These instructions will assume that drive A is your floppy and that
  710.         drive C is your hard disk.  Also assumed is that during your following
  711.         the PC-KAT installation instructions, that you inspected, and if
  712.         needed, updated the CONFIG.SYS and AUTOEXEC.BAT on a bootup floppy
  713.         diskette. Insert your bootup floppy in drive A.  Make sure you don't
  714.         have a write-protect tape on your floppy.  If so, temporarily remove
  715.         it.
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 12
  729.  
  730.  
  731.      2. Type: COPY A:COMMAND.COM C:\/V and press ENTER.  If you ever update
  732.         your operating system, be sure to repeat this operation with the new
  733.         COMMAND.COM.
  734.  
  735.      3. You must add a "SET COMSPEC" line to your AUTOEXEC.BAT file first so
  736.         that PC-KAT will think you powered on off your hard disk.  Do the
  737.         below:
  738.         3.A.  At the "C" prompt, type: EDLIN A:AUTOEXEC.BAT and press ENTER.
  739.         3.B.  At the "*" EDLIN prompt, type: I and press ENTER.
  740.         3.C.  Type: SET COMSPEC=C:\COMMAND.COM and press ENTER.
  741.         3.D.  Press the F6 function key and press ENTER.
  742.         3.E.  Type: E and press ENTER.
  743.  
  744.      4. Restart your computer now, using your updated bootup floppy disk.
  745.         Also, if you have a backup of your bootup floppy disk, make sure the
  746.         backup gets the new AUTOEXEC.BAT put on it.  You must do this restart
  747.         of your computer in order for PC-KAT to work correctly.
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 13
  795.  
  796.  
  797.                      UPDATING THE PC-KAT SYSTEM CONTROL RECORD
  798.                      -----------------------------------------
  799.  
  800.      Before you can regularly use PC-KAT to process and inquire against
  801.      diskettes, you must first update PC-KAT's System Control Record, which
  802.      keeps track of your PC-KAT database as well as holding your default value
  803.      entries.
  804.  
  805.      This manual explains the program prompts.  You can then actually update
  806.      your PC-KAT system control record, taking mostly the default values,
  807.      except where it is obvious that you should over-ride the provided
  808.      default.  If you update your system control record after reading this
  809.      section, come back to this manual and read the remaining sections before
  810.      using the rest of PC-KAT's features.
  811.  
  812.      You minimally only need to update your system control record during PC-
  813.      KAT's install process.  The program used to update the system control
  814.      record is a subprogram within the inquiry program, KATLOOK.EXE.
  815.  
  816.      To perform this, you should be somewhere on your "C" drive with your
  817.      prompt ready to receive a command.  Either type: KATLOOK -M and press
  818.      ENTER or type: KAT -M and press ENTER.  Don't forget the minus sign
  819.      (hereafter called the "dash") if you type: KAT -M.  Typing KATLOOK -M
  820.      will actually load the program faster, as the other method first loads
  821.      the KAT program which in turns loads KATLOOK with the "-M" option.
  822.  
  823.      After receiving a logo display, you'll get the message "No System Control
  824.      Record, --Putting you into add mode."  You'll be prompted for a variety
  825.      of fields, in each case you'll be shown the allowed maximum width of your
  826.      answer.  In some cases, you'll be shown a default answer you'll get if
  827.      you just press ENTER.  The prompts that you will be shown are reproduced
  828.      below.  Supporting comments are provided, when needed, alongside.
  829.  
  830.      Alternatively, if you have previously added a System Control Record,
  831.      you'll be put in the update mode where the prompts are so similar, that
  832.      they do not needed to be documented here.  However, you are not allowed
  833.      by this program to update the database owner's name, once you insert it
  834.      into your PC-KAT database.  This is because of the security arrangement
  835.      of DB-SHARE, -see the manual on DB-SHARE for more information.
  836.  
  837.      When PC-KAT is done processing the system control record, your PC-KAT
  838.      database is closed and you are exited back to the DOS prompt.
  839.  
  840.      For the current software release of PC-KAT, you are also unable to change
  841.      the database owner's password, which is the password needed to change the
  842.      user's password.  The reason for this is unrelated to security reasons,
  843.      and if enough users request it, the ability to change this password will
  844.      be allowed in a future release.
  845.  
  846.      However, if you misspell your name or the database owner's password, you
  847.      are allowed at the end of the system control add function to start the
  848.      add process over again.  Once you've added the system control record,
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 14
  861.  
  862.  
  863.      then unless you want to start again with a totally empty PC-KAT database,
  864.      you will be unable to change these two fields again using this program.
  865.  
  866.      You can update the database owner's name, by ordering an add-on PC-KAT
  867.      software module, because when you order with the PC-KAT order form, you
  868.      specify the new (or same) database owner's name which the add-on software
  869.      program will use to update your old PC-KAT database.
  870.  
  871.      All prompts require a response except where specified as "optional."
  872.      When you are given a default response (shown above the allocated space
  873.      for your answer), you can take the default response by just pressing the
  874.      ENTER key.
  875.  
  876.      Many of these prompts will be repeated during each diskette you process,
  877.      unless you chose at run time to have PC-KAT skip prompting you and to
  878.      instead use the default answers set up in the system control record.
  879.      These prompts which are capable of being repeated for each diskette being
  880.      processed have the parenthetical statement "(for diskette vol. info.)"
  881.      shown beneath the prompt.  At run time, the actual wording of the prompts
  882.      may in some cases be up to 10 percent longer.  For space reasons, they
  883.      are shortened here to allow more space for the right hand commentary.
  884.  
  885.      PROMPT -----------------   COMMENT---------------------------------------
  886.  
  887.      Database Owner's Name      You are required to enter your name or that of
  888.                                 your company.  This name will be shown to you
  889.                                 each time that you run PC-KAT in the manner
  890.                                 described in the DB-SHARE manual.
  891.  
  892.                                 This field is the only field which will
  893.                                 preserve lower case input.  All other fields
  894.                                 in PC-KAT will upper case your input as it is
  895.                                 stored in the PC-KAT database.
  896.  
  897.      Database User Password     The only place that PC-KAT can optionally have
  898.      (optional)                 a security concern is in the inquiry function
  899.                                 and password maintenance function.  Anyone can
  900.                                 always update your database (except the
  901.                                 password portion).
  902.  
  903.                                 The thinking behind this decision is that you
  904.                                 might have your secretary or assistant update
  905.                                 your PC-KAT database as they update your
  906.                                 diskettes.  However, if you have hundreds of
  907.                                 diskettes, you might have some of them devoted
  908.                                 to confidential topics, which might be
  909.                                 revealed in their file name or volume (PC-KAT
  910.                                 entered) heading.  You might want the location
  911.                                 of these diskettes hidden.
  912.  
  913.                                 Thus you can ask that PC-KAT checks for a user
  914.                                 password (which you set up) of anyone asking
  915.                                 to inquire against the PC-KAT database.
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 15
  927.  
  928.  
  929.  
  930.      Password to chg password   Since you may allow more than yourself the
  931.      (optional)                 right to inquire into your database and you
  932.                                 may later change your mind about another
  933.                                 person's right to look into your data base, a
  934.                                 password beside the user password was needed.
  935.                                 Consider this the owner's or administrator's
  936.                                 password.
  937.  
  938.                                 IMPORTANT !!! Do not ever forget this password
  939.                                 !!!  If you forget it, there is no way you can
  940.                                 use either the existing PC-KAT software or
  941.                                 DEBUG's dump command to uncover this password.
  942.                                 A proprietary encryption method stores this
  943.                                 password in your PC-KAT database.  Use a
  944.                                 password that is impossible for you to forget,
  945.                                 yet which is one that few other persons would
  946.                                 ever guess, such as a childhood nickname no
  947.                                 longer used, or your first date's name, etc.
  948.                                 Alternatively, you may want to write your
  949.                                 password down and store it in your safe or
  950.                                 safety deposit box.
  951.  
  952.                                 Note: if you decide not to implement this
  953.                                 administrator's password during the initial
  954.                                 add system control process, you are never
  955.                                 given the opportunity to change your mind.  At
  956.                                 least by the present PC-KAT release.
  957.  
  958.                                 If you aren't excited about requiring a
  959.                                 password at inquiry time, you might want to
  960.                                 implement an administrator password, but skip
  961.                                 for the time being a user password.  If you
  962.                                 know the administrator password, you can
  963.                                 always assign a new user password via the
  964.                                 update system control process.
  965.  
  966.      Enter begin no. for home   The default number is 0001.  PC-KAT allows
  967.                                 designating the location of your diskettes to
  968.                                 be either at work or at home.  Some of the PC-
  969.                                 KAT users may be using a COMPAQ PLUS (like the
  970.                                 author), and thereby be tracking diskettes at
  971.                                 both locations.
  972.  
  973.                                 The purpose of this field is to save you
  974.                                 keystrokes in assigning the volume ID for your
  975.                                 diskette.  You are always allowed to over-ride
  976.                                 the prompted default value.
  977.  
  978.      Enter begin no. for work   The default number is 5001.
  979.  
  980.      # of disk upds b4 sugg.bu  Because PC-KAT involves a database, you are
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 16
  993.  
  994.  
  995.                                 suggested to periodically back up your
  996.                                 database, in case unpredicatible
  997.                                 interruptions, whether hardware or otherwise
  998.                                 caused, destroy your database.  At the start
  999.                                 of each diskette to be processed, you are
  1000.                                 given the option to backup the database.
  1001.                                 However, you may decide to methodically back
  1002.                                 up the database every so many diskettes.  If
  1003.                                 you desire a periodic reminder, insert the
  1004.                                 desired interval here, otherwise assign a very
  1005.                                 high number (e.g., 99).
  1006.  
  1007.      Enter diskette drive char  Typically, you'll probably choose the default
  1008.                                 letter, A.  However, you can choose any
  1009.                                 legitimate floppy disk drive, or drive which
  1010.                                 acts to DOS like a floppy disk drive (refer to
  1011.                                 earlier comments in the Hardware Requirements
  1012.                                 Section).
  1013.  
  1014.                                 If you have an IBM AT, and alternate between
  1015.                                 drive A and B, you should pick the letter used
  1016.                                 the most often.  You are given the opportunity
  1017.                                 inside the cataloging program to over-ride
  1018.                                 this letter.
  1019.  
  1020.      Enter KATWORK.VOL drive    PC-KAT during its processing of a diskette,
  1021.                                 will do a DOS "VOL" command and redirect it's
  1022.                                 output to a disk file, called KATWORK.VOL.  If
  1023.                                 you have an electronic RAM DISK, indicate its
  1024.                                 drive letter here.  The default drive letter
  1025.                                 is the typical hard drive letter, C.
  1026.  
  1027.      Enter KATWORK1.DIR drive   PC-KAT during its processing of a diskette,
  1028.      ENTER KATWORK2.DIR drive   will run another program, KATDRIVE.EXE, which
  1029.                                 creates a directory display file of your
  1030.                                 entire diskette, even if it has subdirectory-
  1031.                                 located files on it.  The unsorted directory
  1032.                                 display file is called KATWORK1.DIR.  PC-KAT
  1033.                                 then runs your DOS program, SORT.EXE, against
  1034.                                 this KATWORK1.DIR file and outputs the sorted
  1035.                                 version of this file under the name
  1036.                                 KATWORK2.DIR.  If you have an electronic RAM
  1037.                                 DISK, indicate its drive letter here.  The
  1038.                                 default drive letter is the typical hard drive
  1039.                                 letter, C.
  1040.  
  1041.      Min bytes floppy file hogs Let's say you create a 1 byte file on an empty
  1042.                                 diskette.  Try it.  Type: ECHO X>A:MYFILE and
  1043.                                 press ENTER.  Now do a DIR A: and press ENTER.
  1044.                                 Write down the number of remaining bytes left.
  1045.                                 Now type: DEL A:MYFILE and press ENTER.  Write
  1046.                                 down the number of remaining bytes left.
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 17
  1059.  
  1060.  
  1061.                                 Subtract the two.  Typically, you'll find 1024
  1062.                                 bytes used up by that 1 byte file!  This
  1063.                                 number, or a different one, if you are using a
  1064.                                 different type of drive, needs to be
  1065.                                 indicated.
  1066.  
  1067.                                 The purpose of this information is for PC-KAT
  1068.                                 to figure out how many bytes the total number
  1069.                                 of your files use on a diskette.  PC-KAT will
  1070.                                 minimally use this number for each filename if
  1071.                                 your filesize is smaller than this number.
  1072.  
  1073.      Default From Hd Drive      Typically this is drive C, the default.  If
  1074.      (for diskette vol. info.)  you ask PC-KAT to prompt you for each diskette
  1075.                                 being processed, you'll be prompted for the
  1076.                                 source hard disk drive, and be given this
  1077.                                 letter as the default answer.
  1078.  
  1079.      Default vol. pathname      The default hard disk source pathname for your
  1080.      (for diskette vol. info.)  diskette file is "VARIES".  If you catalog a
  1081.                                 diskette with no files on it, and you've asked
  1082.                                 not to be prompted for volume heading
  1083.                                 information, PC-KAT substitutes a blank
  1084.                                 pathname.
  1085.  
  1086.                                 The idea behind the pathname is to have the
  1087.                                 inquiry function act similar to how you
  1088.                                 interrogate your directory on your hard disk.
  1089.                                 On your hard disk, you'll typically move
  1090.                                 yourself to a directory, and then query a file
  1091.                                 set against only that directory.
  1092.  
  1093.                                 For example, if you are in a directory for
  1094.                                 your word processing files, the DIR *.DOC will
  1095.                                 scope word processing files, whereas if you
  1096.                                 have a directory for your programming
  1097.                                 development, the DIR *.DOC might scope program
  1098.                                 development or usage documentation files.
  1099.  
  1100.                                 However, to minimize database overhead both to
  1101.                                 reduce disk space utilization and update
  1102.                                 processing time, the directory database is not
  1103.                                 structurally segmented by pathname.  Doing an
  1104.                                 inquiry similar to a DIR *.DOC against your
  1105.                                 \WORK directory, will involve scanning your
  1106.                                 PC-KAT database from the very first record
  1107.                                 through the very last record.  Thus, you'll
  1108.                                 probably want to minimize inquiries where the
  1109.                                 leading characters of the filename are
  1110.                                 irrelevant.
  1111.  
  1112.      Default vol. note          This is a 13 character field, which can be
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 18
  1125.  
  1126.  
  1127.      (for diskette vol. info.)  thought of being a commentary field on the
  1128.                                 diskette's contents or a place for extended
  1129.                                 path information, in case your source hard
  1130.                                 disk pathname is longer than 8 characters long
  1131.                                 (e.g., \LOTUS\TEMPLATE\DOC).   Examples of
  1132.                                 appropriate comments might be "NORTON UTILS",
  1133.                                 "XTALK" or "LOTUS".
  1134.  
  1135.                                 The default note for your diskette volume
  1136.                                 heading is "MISC".  If you catalog a diskette
  1137.                                 with no files on it, and you've asked not to
  1138.                                 be prompted for volume heading information,
  1139.                                 PC-KAT substitutes "SCRATCH" for the volume
  1140.                                 heading note.
  1141.  
  1142.      Default YY+Qtr buy disk    You might want to keep track of how old a
  1143.      (for diskette vol. info.)  diskette is.  The default answer, zero, will
  1144.                                 substitute the current YEAR and QUARTER
  1145.                                 (concatenated together as a 3 digit number).
  1146.                                 When first entering in all your old diskettes,
  1147.                                 if they are on the average 9 months ago, you
  1148.                                 might want to indicate the YY+Qtr for that
  1149.                                 period.  Then after your initial database
  1150.                                 load, you could change the default value back
  1151.                                 to zero.
  1152.  
  1153.      Diskette Format OP SYS     Indicate here the default for whether the
  1154.      (for diskette vol. info.)  diskette is normally formatted under IBM PC
  1155.                                 DOS ('P'), which is the default, or under MS
  1156.                                 DOS ('M').
  1157.  
  1158.                                 These letters do not cause anything special to
  1159.                                 happen, except that they will be redisplayed
  1160.                                 on some screen outputs.  You can use
  1161.                                 alternative letters if you wish.
  1162.  
  1163.      OP SYS Ver. (no dec.pt.)   Indicate here the default for which DOS
  1164.      (for diskette vol. info.)  version number, the diskette was formatted
  1165.                                 under, however do not use a decimal point
  1166.                                 (wasted storage & display space to carry the
  1167.                                 decimal).  Thus 200, the default, refers to
  1168.                                 2.00 DOS.
  1169.  
  1170.      Usual seq_typ is           You may be processing a group of related
  1171.      (for diskette vol. info.)  diskettes.  The grouping may be because you
  1172.                                 are using the DOS BACKUP command (type 'B'),
  1173.                                 which is the default, or because you are using
  1174.                                 the JET COPY utility (discussed in the
  1175.                                 TECHNICAL REFERENCE MANUAL), which is type
  1176.                                 'J'; or because you are cataloging a software
  1177.                                 package containing more than one diskette
  1178.                                 (type 'P').
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 19
  1191.  
  1192.  
  1193.  
  1194.                                 You are free to invent other sequence types.
  1195.                                 However, use 'B' for the DOS BACKUP sequence
  1196.                                 type.  Future PC-KAT software may act upon
  1197.                                 this information.
  1198.  
  1199.                                 For now, just indicate, that when you are
  1200.                                 processing a sequence of diskettes, what will
  1201.                                 be the normal sequence type.  Don't worry if
  1202.                                 most of the time you will not be processing a
  1203.                                 sequence of diskettes.
  1204.  
  1205.      Disk usually part of set   Indicate 'Y' or 'N' (the default), whether the
  1206.                                 normal diskette you intend to catalog will
  1207.                                 belong to a sequentially related set of
  1208.                                 diskettes, such as a full backup set, etc.
  1209.  
  1210.      Enter DOS cmd for B/U      You are highly recommended to perform your PC
  1211.                                 KAT database backup under PC-KAT supervision.
  1212.                                 The default method is via the DOS BACKUP
  1213.                                 command ("BACKUP C:\KATDB.* A:").  You can
  1214.                                 insert any valid DOS command here to
  1215.                                 accomplish your backup.  Your DOS command
  1216.                                 could even be the .BAT file name to do your
  1217.                                 backup (leave out the ".BAT").
  1218.  
  1219.                                 The PC-KAT database will be updated that you
  1220.                                 are about to do a backup, then the database
  1221.                                 will be closed prior to your backup.  Also,
  1222.                                 your PC-KAT log file will note the occurrence
  1223.                                 of a backup being performed.  More about this
  1224.                                 log file later in the manual.
  1225.  
  1226.      Enter label utility name   PC-KAT comes with the free, user group
  1227.                                 program, VOLSER Version 2.00, Copyright 1983
  1228.                                 by T. A. Davis.  As T. Davis does not provide
  1229.                                 an address either in his program or his
  1230.                                 documentation, Applied Foresight is unable to
  1231.                                 ask his permission or to ask users of PC-KAT
  1232.                                 to voluntarily contribute an appreciation
  1233.                                 token to Mr. T. A. Davis.  VOLSER is a label
  1234.                                 utility.
  1235.  
  1236.                                 With VOLSER or an alternative software label
  1237.                                 utility, which you would select here, you can
  1238.                                 update your diskette with the volume ID four
  1239.                                 digit number (use leading zeros to make the
  1240.                                 volume ID 4 digits).  Having the volume ID
  1241.                                 software embedded onto the diskette, saves PC-
  1242.                                 KAT from having to ask you each time what is
  1243.                                 the number on the sticky label outside your
  1244.                                 diskette.  Oh yes, you should have a four
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 20
  1257.  
  1258.  
  1259.                                 digit volume ID on a sticky label outside your
  1260.                                 diskette.
  1261.  
  1262.                                 If you don't care to use VOLSER, indicate the
  1263.                                 label utility program of your choice.
  1264.                                 Norton's Utilities comes with the program,
  1265.                                 LABEL.  IBM PC DOS 3.0 comes with its utility
  1266.                                 program, LABEL.  Make your choice known to PC-
  1267.                                 KAT.
  1268.  
  1269.                                 The unaltered documentation on VOLSER by T. A.
  1270.                                 Davis, is in the file, VOLSER.DOC, which is on
  1271.                                 your PC KAT diskette.
  1272.  
  1273.      Entries Okay               The default answer is 'Y' for Yes.  If you
  1274.                                 want to change one of your answers made above,
  1275.                                 you should answer 'N' for No.  You'll be
  1276.                                 reprompted for every field again, starting
  1277.                                 from the first prompt.
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 21
  1323.  
  1324.  
  1325.                                CATALOGING DISKETTES
  1326.                                --------------------
  1327.  
  1328.                                   INVOKING PC-KAT
  1329.  
  1330.      Efficient and rewarding use of PC-KAT involves continually keeping your
  1331.      PC-KAT database up to date about the contents of all of your diskettes.
  1332.      This is done by the PC-KAT diskette cataloger program function, which can
  1333.      be invoked in a variety of ways.  You can enter the commands in upper or
  1334.      lower case, it makes no difference.  These commands are entered at the
  1335.      DOS prompt level.
  1336.  
  1337.      INVOKE CMD   COMMENT-------------------------------------------------
  1338.  
  1339.      KAT -U       Catalog diskettes until requested to exit or backup my PC-
  1340.                   KAT database.  Provide prompts, with defaults shown, to add
  1341.                   or update unique diskette volume information.  Will be asked
  1342.                   by PC-KAT at the start of the program if location is Home or
  1343.                   Work.
  1344.  
  1345.      KAT -UH      Same as above, except prespecified location is Home.
  1346.  
  1347.      KAT -UW      Same as above, except prespecified location is Work.
  1348.  
  1349.      KAT -U2      Same as KAT -U, except only process for two diskettes.
  1350.  
  1351.      KAT -U2H     Same as KAT -UH, except only process for two diskettes.
  1352.  
  1353.      KAT -UN      Same as KAT -U, except bypass prompting for unique diskette
  1354.                   volume information.  Use the default values based upon the
  1355.                   system control record.
  1356.  
  1357.                   For those users who habitually name their files in such a
  1358.                   manner that just remembering the spelling of part or all of
  1359.                   the file name is all that is necessary to know about, those
  1360.                   users might be satisfied running PC-KAT this way.  It saves
  1361.                   about 30-60 seconds per processed diskette, to use the -N
  1362.                   option.
  1363.  
  1364.                   Alternatively, on many of your diskettes, you might want to
  1365.                   not use the -N option.  For instance, you might want to
  1366.                   state that the involved diskette belongs to the path, UTIL,
  1367.                   and in the note field, state "PC-TALK III", and so forth.
  1368.                   However, some users, lazy like the Author, might not care
  1369.                   about volume heading information, and rely upon the fact
  1370.                   that on this diskette, retrieving by the file name, "PC-
  1371.                   TALK", will always enable PC-KAT to tell me which diskette
  1372.                   volume to look for PC-TALK III.
  1373.  
  1374.                   On diskettes which habitually get reused for totally
  1375.                   different file storage purposes, you might want to always
  1376.                   use the -N option.
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 22
  1389.  
  1390.  
  1391.  
  1392.                   While inside PC-KAT, you can toggle having this "N" option
  1393.                   on or off.
  1394.  
  1395.      KAT -UNH     Same as KAT -UN except prespecified Home as the location.
  1396.  
  1397.      KAT -U2NH    Same as KAT -UNH, except only process for two diskettes.
  1398.  
  1399.      KAT -UA      Same as KAT -U, except floppy to process is on drive A:,
  1400.                   regardless of what drive letter the system control record
  1401.                   points to.
  1402.  
  1403.      KAT -UB      Same as KAT -U, except floppy to process is on drive B:,
  1404.                   regardless of what drive letter the system control record
  1405.                   points to.
  1406.  
  1407.      KAT -LU      Same as KAT -U, except use the PC-KAT database in the
  1408.                   current directory.  Without the -L option, PC-KAT will move
  1409.                   to the root (\) directory to process a PC-KAT database
  1410.                   there.
  1411.  
  1412.      The user can invoke PC-KAT using valid combinations of the above.  Of
  1413.      course, -A and -B can never be used together.  Nor can -H and -W ever be
  1414.      used together.
  1415.  
  1416.      The order in which the options are stated are irrelevant, except that
  1417.      only a number can follow the -U option, immediately to the right of the
  1418.      "U".  Thus, typing KAT -UN and KAT -NU will perform the same thing.  Some
  1419.      of the above options can be chosen from a menu which drives the program.
  1420.      This menu is shown in the "CATALOGING PROCEDURE" subsection below.
  1421.  
  1422.  
  1423.                            DISKETTE HANDLING WITH PC-KAT
  1424.  
  1425.      You should physically and software label all your diskettes with a four
  1426.      digit number.  Write-protected diskettes need not be software labeled.  A
  1427.      physically labeled diskette means that with a soft felt tip pen, you have
  1428.      written a four digit number which is visible on the diskette gum label
  1429.      which sticks on the outside of the diskette.  A software labeled diskette
  1430.      means that when you do a DOS DIR A: against the diskette, that you are
  1431.      shown something like the below as the first two lines of the display:
  1432.         Volume in drive A is 0175
  1433.         Directory of A:\
  1434.  
  1435.      PC-KAT provides you with means to do software labeling from inside the
  1436.      cataloging program.  Refer back to the last prompt in the System Control
  1437.      Record.  The recommended route is to use the numbers 0001-5000 for
  1438.      diskettes initially cataloged at Home, and to use the numbers 5001-9999
  1439.      for diskettes initially cataloged at Work.  If you only have one
  1440.      location, then use the numbers 0001-9999.  These are only
  1441.      recommendations.  The only requirement is that the volume ID must be
  1442.      either blank or a four digit number.  Blank volume ID labels should be
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 23
  1455.  
  1456.  
  1457.      minimized to write-protected diskettes, because each time you catalog the
  1458.      diskette, you have to remind PC-KAT of the volume label number.
  1459.      Diskettes which are software labeled, are automatically recognized by PC-
  1460.      KAT as to what volume label ID it contains.
  1461.  
  1462.      In your diskette containers, you should stack all your diskettes
  1463.      sequentially in numeric order.  It makes no difference how unrelated any
  1464.      neighboring sequenced diskette is, for PC-KAT will provide the logical
  1465.      organization to your diskettes.  However, you'll still find it convenient
  1466.      to keep sequentially logically related diskettes in sequential numeric
  1467.      order, such as for full hard disk backups, etc.  The author reserves
  1468.      three neighboring numbered diskettes for his PC-KAT database backups,
  1469.      since with its some 13,400 plus filenames, it goes a little into the
  1470.      third diskette to back up a PC-KAT database this big.  Doing this is a
  1471.      convenience not a necessity, for the diskette volume inquiry process will
  1472.      remind you of what follows or precedes a diskette (assuming you told PC-
  1473.      KAT about the sequencing originally).
  1474.  
  1475.      A "scratch" diskette is one which is either empty of files, or one which
  1476.      has junk or obsolete files on them and can be erased without worry.  When
  1477.      PC-KAt processes a scratch diskette, it labels the database volume header
  1478.      with the word "SCRATCH."  You can ask PC-KAT for a screen or printout of
  1479.      your SCRATCH volumes.  However, if you don't want to have to run this
  1480.      inquiry to find out where your scratch diskettes are, you could consider
  1481.      temporarily locating your scratch diskettes in a scratch diskette
  1482.      container or separate location.
  1483.  
  1484.  
  1485.                              THE CATALOGING PROCEDURE
  1486.  
  1487.      The cataloging program is menu driven and your choices for action are
  1488.      displayed as follows:
  1489.  
  1490.      -------------------------------------------------------------------------
  1491.      PT: DESCRIPTION                     OPT: DESCRIPTION
  1492.  
  1493.      P   Insert diskette now to PROCESS   E   EXIT program now
  1494.      H   change location to HOME          W   change location to WORK
  1495.      V   change database VOLUME header    L   change diskette volume LABEL
  1496.      D   diskette dir/w & DEL option      F   FORMAT a diskette
  1497.      T   TOGGLE vol hdr prompting on/off  S   SWITCH to another diskette drive
  1498.      B   BACKUP database & exit program
  1499.  
  1500.      PARMS ON: Locn=> HOME; Prompting=> ON; Directory=> ROOT; Floppy=> A:
  1501.                                      P
  1502.      Do: B,D,E,F,H,L,P,S,T,V,W ?    > <
  1503.      -------------------------------------------------------------------------
  1504.  
  1505.      Most of the prompts and activity occurring in the PC-KAT cataloging
  1506.      procedure is self evident, based upon the user understanding the system
  1507.      control record update process and being able to read the cataloging
  1508.      procedure displays and prompts.
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 24
  1521.  
  1522.  
  1523.  
  1524.      This documentation will cover the portions of this procedure which may
  1525.      not be completely self-evident.
  1526.  
  1527.      1.  In the overview section, PC-KAT was discussed being smart enough to
  1528.          know that you hadn't made any changes since your last cataloging
  1529.          process against that diskette.  There is one ramification to this
  1530.          smartness.  If your only change to a previously processed diskette,
  1531.          is that you renamed a file, then PC-KAT will not process the
  1532.          diskette, because renaming an existing file on a diskette will not
  1533.          impact either of the two captured totals.  These two totals, you will
  1534.          recall, deal with the total number of files on the diskette, and the
  1535.          sum total of file dates + times + sizes covering that diskette.
  1536.  
  1537.      2.  When you are displayed the volume heading information for a
  1538.          previously cataloged diskette, you are given the following column
  1539.          headings:
  1540.  
  1541. VOL# --PATH-- NOTE/EXT-PATH LAST UPDATE #FIL KBLF L F O VER BUY NV TSQ NEXT LAST
  1542.  
  1543.  
  1544.      The unobvious column headings above mean the following:
  1545.  
  1546.      KBLF         The number of kilobytes available for additional file use.
  1547.  
  1548.      L            Location where the prior cataloging processing took place.
  1549.  
  1550.      F            The letter of the hard disk from which these files came
  1551.                   from.
  1552.  
  1553.      O            The operating system type under which the cataloged diskette
  1554.                   was formatted.
  1555.  
  1556.      VER          The operating system version number under which the
  1557.                   cataloged diskette was formatted.
  1558.  
  1559.      NV           The newest version file of all files on this diskette.  This
  1560.                   information is only available if the add-on software module,
  1561.                   which does the aging analysis, is owned and ran against your
  1562.                   PC-KAT database.  This add-on software module is not yet
  1563.                   available, as of the release time of this document.  It will
  1564.                   be available in a matter of months.
  1565.  
  1566.                   When this field is operational, if it contained the number
  1567.                   "2" or higher, it would mean that nothing on this file is
  1568.                   most recent compared to same named files on other diskettes.
  1569.                   You could conceivably reuse this diskette if you aren't
  1570.                   interested in prior versions of your files.
  1571.  
  1572.      TSQ          This represents two columns of information without a
  1573.                   separating blank space between them:
  1574.                   T     Sequence type (eg, B=BACKUP, J=JET, P=SOFTWARE
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 25
  1587.  
  1588.  
  1589.                         PACKAGE)
  1590.                   SQ    Sequence number (ie, 01-99).
  1591.  
  1592.      3.  You can remove the diskette from the disk drive which is being
  1593.          cataloged when you see on your screen either of the following two
  1594.          messages.  If you have another diskette to process, you can insert it
  1595.          at this time.
  1596.  
  1597.          a) "Will display each input directory filename as it is processed:"
  1598.          b) "Input directory has no files on it--processing as a scratch
  1599.             volume."
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 26
  1653.  
  1654.  
  1655.                        INQUIRING AGAINST THE PC-KAT CATALOG
  1656.                        ------------------------------------
  1657.  
  1658.                                   INVOKING PC-KAT
  1659.  
  1660.      Before you actually update and inquire against your PC-KAT database, you
  1661.      should read the last remaining section, which comes in the next section
  1662.      "MAINTAINING AND RECOVERING YOUR DATABASE."
  1663.  
  1664.      The main purpose for having PC-KAT is to ask it which diskette(s) has
  1665.      such and such file on it?  This is done by the PC-KAT catalog inquiry
  1666.      program function, which can be invoked in a variety of ways.  You can
  1667.      enter the commands in upper or lower case, it makes no difference.  These
  1668.      commands are entered at the DOS prompt level.
  1669.  
  1670.      INVOKE CMD   COMMENT-------------------------------------------------
  1671.  
  1672.      KATLOOK      This is the quickest way to look at your PC-KAT database.
  1673.                   If you chose the alternate route of KAT -D, it would invoke
  1674.                   KATLOOK anyway.  So you save having to have the computer
  1675.                   first load KAT.EXE followed by then loading KATLOOK.EXE if
  1676.                   you just type KATLOOK and press ENTER.
  1677.  
  1678.      KAT -D       Same as KATLOOK, except computer takes a couple of seconds
  1679.                   longer to function.
  1680.  
  1681.      KATLOOK -P   Same as KATLOOK, except you request that PC-KAT does not
  1682.                   show in the PATH & EXT PATH/NOTE columns the subdirectory
  1683.                   information if the file entry sat in a subdirectory on the
  1684.                   diskette.  The only thing that would be shown in these two
  1685.                   columns would be information from the diskette volume header
  1686.                   record.
  1687.  
  1688.                   Since most users will not be utilizing subdirectories on
  1689.                   their diskettes, KATLOOK gives the same results as entering
  1690.                   KATLOOK -P.
  1691.  
  1692.                   KATLOOK -P was inserted into the product during the
  1693.                   debugging phase of catching the individual file entry
  1694.                   elongated directory name at display time.  You'll recall
  1695.                   from the Overview subsection in the Introduction that the
  1696.                   database only carries a numeric code for the subdirectory
  1697.                   diskette location it belongs with in each database record.
  1698.                   However, this feature was left in the program, since some
  1699.                   users might want to take advantage of this option, and it
  1700.                   really causes no overhead to the program's performance to
  1701.                   leave it in.
  1702.  
  1703.      KAT -DP      See above discussion about KAT -D.  Otherwise, this is the
  1704.                   same as entering KATLOOK -P.
  1705.  
  1706.      KATLOOK -L   Inquire against the PC-KAT database located in the current
  1707.                   directory.
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 27
  1719.  
  1720.  
  1721.  
  1722.      KAT -LD      See above discussion about KAT -D.  Otherwise, this is the
  1723.                   same as entering KATLOOK -L.
  1724.  
  1725.  
  1726.                                THE INQUIRY PROCEDURE
  1727.  
  1728.      The inquiry program is menu driven and your choices for action are
  1729.      displayed as follows:
  1730.  
  1731.      -------------------------------------------------------------------------
  1732.      CHOOSE TYPE OF DIRECTORY DISPLAY DESIRED:
  1733.      1.  Process individual dir argument line.
  1734.      2.  Process all cataloged files for a given volume number.
  1735.      3.  Process all cataloged files for the entire database.
  1736.      4.  Listing of cataloged diskette volumes.
  1737.      5.  Listing of uncataloged diskette volumes.
  1738.      6.  Exit program.
  1739.                                     6
  1740.      Enter option number:          > <
  1741.      -----------------------------------------------------------------------
  1742.  
  1743.      Most of the prompts and activity occurring in the PC-KAT inquiry
  1744.      procedure is self evident, based upon the user understanding the PC-KAT
  1745.      cataloging process and being able to read the inquiry procedure displays
  1746.      and prompts.
  1747.  
  1748.      This documentation will cover the portions of this procedure which may
  1749.      not be completely self-evident.
  1750.  
  1751.      1.  If your PC-KAT database was set up with a user password, you are
  1752.          asked for it in this program.  You must provide the user password in
  1753.          order to inquire against the PC-KAT database.  When you type in your
  1754.          password, you will not see what you type in nor will your cursor
  1755.          move.  That is normal.  This way, your friend behind you won't see
  1756.          your password.
  1757.  
  1758.      2.  When you are displayed the filename heading information, you are
  1759.          given the following column headings:
  1760.  
  1761. VOL# FILENAME.EXT FLDATE FLTM --SIZE- --PATH-- NOTE/EXT-PATH LTSQGT LAST-UPDATE
  1762.  
  1763.          With the exception of "FILENAME.EXT" and "LTSQGT", the above column
  1764.          headings also appear in the previous section in "THE CATALOGING
  1765.          PROCEDURE" subsection.
  1766.  
  1767.          Two exception to being the same as THE CATALOG PROCEDURE heading are
  1768.          the "--PATH-- NOTE/EXT-PATH" headers.  These columns will show the
  1769.          actual diskette subdirectory (the first 22 characters) which the
  1770.          cataloged file sits in, if such is the case, rather than the volume
  1771.          heading Note/Ext-Path information.  Again, if the diskette file does
  1772.          not reside on the diskette in a subdirectory, the shown information
  1773.          derives from the volume label record.
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 28
  1785.  
  1786.  
  1787.  
  1788.          LTSQGT represents five columns of information without a separating
  1789.          blank space between them.
  1790.  
  1791.          L   Location where the prior cataloging processing for this disk took
  1792.              place.
  1793.  
  1794.          T   Sequence type (eg, B=BACKUP, J=JET, P=SOFTWARE PACKAGE).
  1795.  
  1796.          SQ  Sequence number (ie, 01-99).
  1797.  
  1798.          G   How many generations old is this filename in relationship to the
  1799.              most current file with this same FILENAME.EXT, which is
  1800.              generation 0.  Generation 9 would be for the 9th plus higher
  1801.              generations.  This information and that of the following adjacent
  1802.              field is not updated by the base PC-KAT package.  An add-on
  1803.              software module program, which does the aging analysis, will
  1804.              update this field.
  1805.  
  1806.          T   Is the generation number for this FILENAME.EXT tied ("Y" or
  1807.              blank).
  1808.  
  1809.      3.  If you choose the directory display option number 1 (Process
  1810.          individual dir argument line) and ask to "Suppress console output",
  1811.          you can ask that the displayed output go either to the printer or to
  1812.          a file.  If you choose a file output, you are given the opportunity
  1813.          to use the filename, KATDIR.OUT, or you can create your own valid
  1814.          filename.  File-directed output will not contain the column headings.
  1815.          A DOS batch command file, KATSORT, is provided which will sort
  1816.          KATDIR.OUT in reverse chronological order.  You must exit this
  1817.          program and execute the procedure, KATSORT, at the DOS prompt level.
  1818.  
  1819.      4.  If you choose the directory display option number 1 (Process
  1820.          individual dir argument line), you might be a little unfamiliar with
  1821.          your search options.  The program at this point displays the
  1822.          following instructions:
  1823.  
  1824.             "For your search argument, you'll be asked for a string value and
  1825.             how to use this string in the search (exact compare, anchored
  1826.             substring compare, or un-anchored substring compare - E, A, U).
  1827.             You are not allowed to use the following characters: '*', '?',
  1828.             '+'.  Just pressing ENTER for a string value indicates no
  1829.             restriction."
  1830.  
  1831.          The DOS DIR command provides an anchored substring search capability.
  1832.          If you typed: DIR AUTO* and pressed ENTER, you would be doing an
  1833.          anchored substring compare.  Although DOS does not provide an un-
  1834.          anchored substring search, if it did, typying: DIR *TO* and pressing
  1835.          ENTER, would provide you with a list of filenames where floating
  1836.          anywhere in the filename portion are the two neighboring characters
  1837.          "TO".  This is an example of an un-anchored substring search.
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 29
  1851.  
  1852.  
  1853.          Although, PC-KAT provides an un-anchored substring compare, this type
  1854.          of search on the filename portion will cause every filename entry in
  1855.          your PC-KAT database to be scanned, which can take awhile depending
  1856.          on the size of your PC-KAT database.
  1857.  
  1858.          The TECHNICAL REFERENCE MANUAL overviews the structure of PC-KAT's
  1859.          database design and provides an  elaborate example list representing
  1860.          a range of searchs ordered by a most efficient search argument to a
  1861.          least efficient search argument.
  1862.  
  1863.          However, don't be afraid to use the search strategy you need to
  1864.          accomplish the job you want done.  With a 12,000 record database,
  1865.          best case searches are a few seconds long and worst case searches are
  1866.          a few minutes long.
  1867.  
  1868.      5.  If you choose to provide a path argument search and to have it used
  1869.          against cataloged filenames, it is only used against the diskette
  1870.          volume label pathname, and not against an individual diskette file
  1871.          directory.
  1872.  
  1873.      6.  If you choose to only provide a path argument search (no filename/ext
  1874.          search argument), you'll be asked if you want the search to be only
  1875.          against cataloged volume header records rather than against cataloged
  1876.          filenames.  Choosing the volume header search will make your scan a
  1877.          whole lot faster.
  1878.  
  1879.      7.  Diskettes that are marked "SCRATCH" have that indication in the
  1880.          volume heading "extended path/note" field whereas in the accompanying
  1881.          "path" field, it is left blank.  Nevertheless, if you choose to
  1882.          provide a path argument search with the value "SCRATCH" or "scratch"
  1883.          and to have it used only against cataloged volume header records, you
  1884.          will be provided with a list of scratch diskettes.
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 30
  1917.  
  1918.  
  1919.                            TAKING CARE OF  YOUR DATABASE
  1920.                            -----------------------------
  1921.  
  1922.                                      OVERVIEW
  1923.  
  1924.      This section covers the following activities:
  1925.  
  1926.         1.  Conservative Updating
  1927.         2.  Backup
  1928.         3.  The Log File
  1929.         4.  Integrity Analysis
  1930.  
  1931.      A related section on Recovery is included in the TECHNICAL REFERENCE
  1932.      MANUAL, because not every user will ever need it.  However, every user
  1933.      should be prepared for it by following the recommendations below.
  1934.  
  1935.  
  1936.                                CONSERVATIVE UPDATING
  1937.  
  1938.      Databases are delicate creatures.  Most programs which work with
  1939.      databases, assume that all the proper connections are made between the
  1940.      different records in a database.  Such programs, when they come across
  1941.      the first data record with its associated pointer addresses to another
  1942.      record failing to properly point, will abort.  Thus often a very large
  1943.      database is at the mercy of one bad pointer.  Pointers, like other
  1944.      portions of a disk file, can be disturbed by a variety of external
  1945.      hardware and software factors, many of which lie totally outside of the
  1946.      software which is specifically written for the database.
  1947.  
  1948.      Conservative practices are to frequently backup up the PC-KAT database
  1949.      and to do a periodic integrity analysis of the database.  If you're doing
  1950.      a hundred or more diskettes in the beginning in a day, then maybe every
  1951.      33-50 diskettes, back up your PC-KAT database.  If you're updating a few
  1952.      diskettes per day, then one or two days a week you should back up the PC-
  1953.      KAT database.
  1954.  
  1955.  
  1956.                                       BACKUP
  1957.  
  1958.      You are advised to back up your database while inside the KAT -U (or any
  1959.      variation of the -U option) program.  Your database backup will be made
  1960.      according to the instructions you gave PC-KAT in updating your system
  1961.      control record.  Most persons will want to take advantage of the default
  1962.      backup command which one is prompted with during the system control
  1963.      record add process.
  1964.  
  1965.      During the KAT -U program session, you can choose to backup your database
  1966.      at the beginning of each processing loop, or after you have processed the
  1967.      number of diskettes equal to the reminder interval count you provide PC-
  1968.      KAT in your system control record update process.
  1969.  
  1970.      The existence and usefulness of your PC-KAT log file is discussed
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 31
  1983.  
  1984.  
  1985.      shortly, however it relevant to note now that PC-KAT records in this log
  1986.      file when you made a backup of your database.  It also makes a record
  1987.      entry, including the volume number, of each updated diskette.
  1988.  
  1989.      For the above reason, it is a good idea to update PC-KAT against the
  1990.      diskettes you just backed up your database onto, right after doing the
  1991.      backup and before processing any other diskettes.  This way, when you
  1992.      interrogate your PC-KAT log file, those diskettes which immediately
  1993.      follow a backup record entry are the diskettes which contain your
  1994.      database.  This is useful, when looking for your couple-to-several
  1995.      generation old set of PC-KAT database backup diskettes to reuse.  You can
  1996.      also use PC-KAT's inquiry function to find out the same information, but
  1997.      some people may prefer one method over the other method.  The PC-KAT log
  1998.      file's main purpose is for recovery and not for locating backup diskette.
  1999.  
  2000.      Despite PC-KAT's ability to inform you of which diskette follows in a
  2001.      sequence, you'll still find it more convenient, if your PC-KAT database
  2002.      backup span across neighboring numbered diskettes.  Thus when you
  2003.      initially number your diskettes, you might want to set aside 3-4
  2004.      neighboring sequence for backing up your PC-KAT database.  It currently
  2005.      takes about 2.5 diskettes to backup a PC-KAT database containing 13,400
  2006.      plus directory entries, which covers about 600 diskettes.  You should
  2007.      felt-tip label these diskettes, beside the normal 4 digit number, with
  2008.      information such as:
  2009.                                        0333
  2010.             KATDB.*  1 of 4
  2011.             See 0334-0336
  2012.             Verified: 850301/850501/850701
  2013.             850901
  2014.  
  2015.      The above label shows the following information:
  2016.  
  2017.         1.  The volume ID number for this diskette.
  2018.         2.  Information that the diskette contains a backup of the PC-KAT
  2019.             database.
  2020.         3.  Information that this diskette is number 1 of a set of 4 backup
  2021.             diskettes.
  2022.         4.  The numerous different dates for which this database was a backup
  2023.             of a PC-KAT database right after it had been okayed via a database
  2024.             integrity analysis run.  In this instance, the verify dates spill
  2025.             over onto line four of the label.
  2026.  
  2027.      In conjunction with using the DOS BACKUP command, one should periodically
  2028.      perform a CHKDSK /F.  In the April 23, 1985, issue of PC WEEK, a letter
  2029.      to the editor by a VP of SyntheSys Consulting Inc., Syracuse, NY,
  2030.      entitled "Fixing BACKUP Bugs," refers to "problems with the [BACKUP]
  2031.      program if CHKDSK detects any errors on the disk you are trying to back
  2032.      up.  The user should be sure to use CHKDSK to correct any problems with
  2033.      the hard disk before using BACKUP (i.e., use CHKDSK with the /F option)."
  2034.  
  2035.                                    THE LOG FILE
  2036.  
  2037.      Each diskette that you process by PC-KAT causes a record to be written to
  2038.      a plain ASCII-type file (useable by most word processors), called
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 32
  2049.  
  2050.  
  2051.      KATDB.LOG.  When you backup the PC-KAT database is recorded here too.
  2052.      The information written about the diskette processed is in the following
  2053.      format (example data displayed beneath the format).  The format heading
  2054.      here does not appear in the file, KATDB.LOG, nor by the KATLOG printout.
  2055.  
  2056.        LN  LOC VOL# YYMMDD HHMM TOT-REC-COUNT
  2057.         1    H 0075 850503 1354 13035
  2058.         2    H B/U  850503 1355
  2059.         3    H 0174 850503 1400 13039
  2060.         4    H 0175 850503 1400 13043
  2061.         5    H 0176 850503 1401 13047
  2062.         6    H 0199 850503 1401 13099
  2063.  
  2064.      The main reason for this log file is in the unlikely event that something
  2065.      happens either to your hard disk or to your database and you need to do a
  2066.      recovery using an earlier backed up PC-KAT database.  The exact
  2067.      procedures you'll follow are given in the TECHNICAL REFERENCE MANUAL.
  2068.  
  2069.      Another usage for the log file, if you want to use it in such a manner
  2070.      (as shown in the above example), was earlier discussed in the subsection,
  2071.      BACKUP.  The above example reflects the fact that after processing volume
  2072.      0075, the user backed his database over three diskettes, 0174-0176, after
  2073.      which he updated PC-KAT with the directory information of diskettes 0174-
  2074.      0199.
  2075.  
  2076.      A DOS batch procedure file, called KATLOG.BAT, is provided to aid you in
  2077.      inquiring against your PC-KAT log file.  KATLOG can be invoked in a
  2078.      variety of ways.  You can enter the commands in upper or lower case, it
  2079.      makes no difference.  These commands are entered at the DOS prompt level.
  2080.  
  2081.      INVOKE CMD      COMMENT--------------------------------------------------
  2082.  
  2083.      KATLOG          Typing just this causes the entire log file to be
  2084.                      continuously printed, using the KPRINT program.  KPRINT
  2085.                      is explained in Appendix A.  Lines numbers are printed
  2086.                      for this option.
  2087.  
  2088.      KATLOG 35       Any number is allowed.  Typing this causes the last 35
  2089.                      lines of your log file to be displayed to your screen.
  2090.                      KATLOG uses your DOS program, MORE.COM, so be sure to
  2091.                      have it available (via your PATH) to be executed in the
  2092.                      directory from which you execute KATLOG.  With the MORE
  2093.                      program, if you ask for more than a screen worth, you'll
  2094.                      be shown a screen worth at a time.  Pressing any key
  2095.                      (except the CTRL-BREAK combination) will cause the next
  2096.                      page to be displayed to the screen.  Holding down the
  2097.                      CTRL key while pressing the BREAK key will abort KATLOG
  2098.                      -- you'll be asked if you want to terminate the batch
  2099.                      procedure then.  If you answer "Y", the batch procedure
  2100.                      will immediately abort.
  2101.  
  2102.      KATLOG 35 PRN   Same as KATLOG 35, except output is printed, and the DOS
  2103.                      program, MORE.COM is not used.
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 33
  2115.  
  2116.  
  2117.  
  2118.  
  2119.                                 INTEGRITY ANALYSIS
  2120.  
  2121.      Every once in awhile (perhaps once a month), an integrity analysis should
  2122.      be done.  It really takes no work on your part, and doing it while you
  2123.      are out to eat is the easiest way to schedule it into your day.  More is
  2124.      said about doing an integrity analysis in a subsection below.
  2125.  
  2126.      There is nothing magic about the database integrity check program.  It is
  2127.      an option in the KATLOOK (or KAT -D option) program.  First, get inside
  2128.      to KATLOOK's menu choice.  Refer to the section, INQUIRING AGAINST THE
  2129.      PC-KAT CATALOG, if you forget how to invoke KATLOOK.  To the following
  2130.      prompts, make the following responses:
  2131.  
  2132.      PROMPT------------------------   RESPONSE   COMMENT----------------------
  2133.  
  2134.      Enter option number:             3          "Process entire database"
  2135.                                                  option
  2136.  
  2137.      Suppress console output?         ENTER      Default is "N", the correct
  2138.                                                  choice
  2139.  
  2140.      Printout desired?                ENTER      Default is "N", the correct
  2141.                                                  choice
  2142.  
  2143.      Pause for each screen?           ENTER      Default is "N", the correct
  2144.                                                  choice
  2145.  
  2146.      KATLOOK will thereupon start from the beginning of your database and
  2147.      display every entry in your PC-KAT database.  Every single record in
  2148.      every portion of your database will be retrieved.  This can take an hour
  2149.      and a half if using a COMPAQ PLUS with 12,500 directory entries and 580
  2150.      diskettes cataloged.  If you have an IBM AT, your response time will be
  2151.      better.
  2152.  
  2153.      A good time to do this, as earlier said, is during eating time.  When you
  2154.      come back to your machine then, you'll immediately know if any problem
  2155.      was encountered.  If the last two lines displayed show the last entry in
  2156.      your database followed by the successful database close message, then you
  2157.      have a clean database.
  2158.  
  2159.      At this point, you are advised to backup up your database and label it as
  2160.      a "VERIFIED" backup.  Do not recycle these backup diskettes until you
  2161.      have done at least another verified backup in the future using another
  2162.      set of diskettes.  Once you have done this backup, you no longer need the
  2163.      current hard disk resident KATDB.LOG file.  Type: DEL KATDB.LOG and press
  2164.      ENTER.  Don't worry, immediately upon doing your next PC-KAT process,
  2165.      KATDB.LOG will be recreated and start growing again.
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 34
  2181.  
  2182.  
  2183.  
  2184.                                TROUBLE SHOOTING TIPS
  2185.  
  2186.      If you are ever aborted from PC-KAT during the cataloging program, or if
  2187.      the cataloging program processes less than the full number of filenames
  2188.      on a diskette, check the free space on the device holding the three work
  2189.      files, KATWORK.VOL, KATWORK1.DIR, KATWORK2.DIR.  Also, type out these
  2190.      three work files and see if the operating system issued any error
  2191.      messages.  If you see the message "Exec Failure," it may mean that your
  2192.      "FILES=" statement is either missing or understated in your CONFIG.SYS
  2193.      file.
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 35
  2247.  
  2248.  
  2249.                                  ONLINE ASSISTANCE
  2250.  
  2251.      You already know about the online assistance that the command, KATBOOK,
  2252.      provides.  That is what you executed to print out this manual.  KATBOOK
  2253.      also prints out three other manuals: (1) INSTALLATION FOR NEW COMPUTER
  2254.      USERS, (2) TECHNICAL REFERENCE MANUAL and (3) THE DB-SHARE PROGRAM.
  2255.  
  2256.      Typing:   KAT    and pressing the ENTER key will display the commands you
  2257.      can type in to run the various functions of PC-KAT.
  2258.  
  2259.      Typing:   KAT > PRN   and pressing the ENTER key will print out the above
  2260.      display.
  2261.  
  2262.      Typing:   KAT -O    and pressing the ENTER key will print out an order
  2263.      form, along with an explanation of registration benefits.
  2264.  
  2265.      Typing:   KAT -P    and pressing the ENTER key will print out a problem
  2266.      form which can be used for submitting problems and/or enhancement
  2267.      requests.
  2268.  
  2269.      Typing:   KPRINT   and pressing the ENTER key will display the features
  2270.      of the KPRINT programmer's print program.
  2271.  
  2272.      Typing:   KPRINT -?C>PRN   and pressing the ENTER key will print out the
  2273.      above display.
  2274.  
  2275.      Typing:   KPRINT -?K   and pressing the ENTER key will display how to
  2276.      interface your printer with the KPRINT program.
  2277.  
  2278.      Typing:   KPRINT -?KC>PRN   and pressing the ENTER key will print out the
  2279.      above display.
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 36
  2313.  
  2314.  
  2315.                                     APPENDIX A:
  2316.                              ERRATA RE: KPRINT PROGRAM
  2317.  
  2318.      Note: for additional information about the KPRINT programmer's print
  2319.      program, refer to the preceeding section, "Online Assistance."
  2320.  
  2321.      Due to the Lattice C Compiler not supporting LPT2 and COM2, KPRINT will
  2322.      not work with either of these two ports.  Carl Warren in MINI-MICRO
  2323.      SYSTEMS, April 1985 (page 187), provides a way for your computer to think
  2324.      of LPT2 as LPT1 (and vice-versa) though.  A BASIC program, he provides,
  2325.      based upon printer port information discussed in the IBM Technical
  2326.      Reference Manual, pages 5-25, is used to swap printer port locations for
  2327.      the duration of a power-on session.  The program is reproduced below:
  2328.  
  2329.           05 REM DEFINE THE SEGMENT LOCATION
  2330.           10 DEF SEG = &H40
  2331.           15 REM FIND THE CONTENTS OF THE PORTS
  2332.           20 A = PEEK(&H8): B = PEEK(&H9)
  2333.           30 C = PEEK(&HA): D = PEEK(&HB)
  2334.           35 REM NOW SWAP THEM
  2335.           40 POKE &H8,C : POKE &H9,D
  2336.           50 POKE &HA,A : POKE &H8,B
  2337.           55 SYSTEM
  2338.  
  2339.      If this program was located in your root directory under the name,
  2340.      SWAPLPT.BAS, and you added the line, "BASICA \SWAPLPT", to your
  2341.      \AUTOEXEC.BAT file, this would be done for you automatically when you
  2342.      power on the computer.  If you need to use COM2, use the DOS MODE command
  2343.      to associate COM2 with your LPT1 port.  For both the LPT2 and COM2
  2344.      solution discussed here, your KPRINT.CTL file would use a "T P 1" line.
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.      USER MANUAL Ver. 1.2      Copyright 1986 R.H. Martin        Page 37
  2379.  
  2380.  
  2381.                                     APPENDIX B:
  2382.                                PROVIDED PC-KAT FILES
  2383.  
  2384.      The PC-KAT distribution diskette contains these files:
  2385.  
  2386.      READ     ME    A short introductory note.  To be read first.
  2387.      MANUAL   OQT   The compressed PC-KAT user manual.
  2388.      NOVICE   OQT   The compressed install manual for novice computer users.
  2389.      TECHREF  OQT   The compressed PC-KAT Technical Reference Manual.
  2390.      DBSHARE  OQT   The compressed manual explaining DB-SHARE Software.
  2391.      KATBOOK  BAT   The DOS Batch process to print manual.  Type: KATBOOK.
  2392.      KATBOOK2 BAT   Used by KATBOOK to print manual.  Do not execute this.
  2393.      KAT      EXE   PC-KAT program to update control record and catalog
  2394.                     diskette directory information into PC-KAT database.
  2395.      KATLOOK  EXE   PC-KAT program to allow inquiry against PC-KAT database.
  2396.      KATDRIVE EXE   PC-KAT program used by KAT.EXE to scan diskette directory.
  2397.      KPRINT   EXE   Multi-feature print program.  Made for programmers.
  2398.      KATLOG   BAT   This & KATSTRIP.BAT are used in maintaining & recovering
  2399.      KATSTRIP BAT   PC-KAT.
  2400.      KATSORT  BAT   Batch file to sort cataloged filenames in reverse
  2401.                     chronological order.  Use KATLOOK to output a file first.
  2402.      KATORDER FRM   Type: KAT -O to print this PC-KAT order form.
  2403.      KATBUG   FRM   Type: KAT -P to print this PC-KAT problem report form.
  2404.      KATDB    DBD   The PC-KAT database comprises this and the next 5 files.
  2405.      KATDB    DA1   " ".
  2406.      KATDB    DA2   " ".
  2407.      KATDB    DA3   " ".
  2408.      KATDB    KE1   " ".
  2409.      KATDB    KE2   " ".
  2410.      KATAD    BAT   This & KATAD.KP, if copied to hard disk, support printing
  2411.      KATAD    KP    the PC-KAT announcement sheet.  Type: KATAD & press ENTER.
  2412.      USQ      COM   This & SQ (both public domain programs by Bill Pearson)
  2413.                     allowed the PC-KAT manual to be compressed/decompressed.
  2414.                     SQ.EXE and SQ.DOC files are not provided with PC-KAT.
  2415.      VOLSER   COM   This is a device volume labeler program in the public
  2416.                     domain written by T. A. Davis.  Can be used by PC-KAT.
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.